Xbasic
array append_arrays Method
Syntax
New_Array as P = <array>.append_arrays( Array1 as P, Array2 as P [, ArrayN as P ] )
Arguments
- Array1Pointer
The first array.
- Array2Pointer
The second array.
- ArrayNPointer
Specify as many additional arrays as desired.
Returns
- New_ArrayPointer
Returns the new property composed of the input arrays.
Description
Appends one or more arrays to an array.
Discussion
The <array>.append_arrays() method appends Array2 to Array1 to produce New_Array. Both Array1 and Array2 must have one dimension and have the same structure.
Example
dim cars[10] as P cars.initialize_properties("manufacturer|model",<<%str% Ford|Taurus Ford|Focus GM|Malibu Dodge|Stratus %str%) dim trucks[10] as P trucks.initialize_properties("manufacturer|model",<<%str% Ford|F-150 Ford|Ranger Dodge|Dakota %str%) dim vehicles[2] as P vehicles.append_arrays(cars,trucks) ? vehicles.dump_properties("manufacturer model") = Ford Taurus Ford Focus Ford F-150 Ford Ranger Ford Taurus Ford Focus GM Malibu Dodge Stratus Ford F-150 Ford Ranger Dodge Dakota